home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat2 / standard / sigprocmask.z / sigprocmask
Encoding:
Text File  |  2002-10-03  |  5.0 KB  |  133 lines
  1.  
  2.  
  3.  
  4. SSSSIIIIGGGGPPPPRRRROOOOCCCCMMMMAAAASSSSKKKK((((2222))))                                                  SSSSIIIIGGGGPPPPRRRROOOOCCCCMMMMAAAASSSSKKKK((((2222))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      sigprocmask - alter and return previous state of the set of blocked
  10.      signals (POSIX)
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssiiiiggggnnnnaaaallll....hhhh>>>>
  14.  
  15.      iiiinnnntttt ssssiiiiggggpppprrrrooooccccmmmmaaaasssskkkk((((iiiinnnntttt ooooppppeeeerrrraaaattttiiiioooonnnn,,,, ssssiiiiggggsssseeeetttt____tttt ****sssseeeetttt,,,, ssssiiiiggggsssseeeetttt____tttt ****oooosssseeeetttt))));;;;
  16.  
  17. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.      _s_i_g_p_r_o_c_m_a_s_k manipulates the set of signals which are blocked from
  19.      delivery to the thread.
  20.  
  21.      A non-NULL _s_e_t specifies the set of signals to use in modifying the
  22.      currently-active set, and the incoming signals may be added to, deleted
  23.      from, or completely replace the active set, as specified by the _o_p_e_r_a_t_i_o_n
  24.      parameter, which may have the following values (as defined in
  25.      <_s_i_g_n_a_l._h>):
  26.  
  27.      SSSSIIIIGGGG____NNNNOOOOPPPP        Do not alter current signal mask
  28.      SSSSIIIIGGGG____BBBBLLLLOOOOCCCCKKKK      Add specified signals to those in current mask
  29.      SSSSIIIIGGGG____UUUUNNNNBBBBLLLLOOOOCCCCKKKK    Remove the specified signals from current mask
  30.      SSSSIIIIGGGG____SSSSEEEETTTTMMMMAAAASSSSKKKK    Replace current mask with incoming one
  31.  
  32.      If _o_s_e_t is not NULL, the current set of blocked signals (before
  33.      modification) is returned in the space to which it points.  In this way,
  34.      with a NULL _s_e_t and SSSSIIIIGGGG____NNNNOOOOPPPP _o_p_e_r_a_t_i_o_n the user can determine the current
  35.      signal mask.
  36.  
  37.      Routines described in _s_i_g_s_e_t_o_p_s(3) are used to create and examine the _s_e_t
  38.      and _o_s_e_t signal masks.
  39.  
  40.      It is not possible to block SSSSIIIIGGGGKKKKIIIILLLLLLLL or SSSSIIIIGGGGSSSSTTTTOOOOPPPP; this restriction is
  41.      silently imposed by the system.
  42.  
  43.      POSIX specifies (contrary to BSD and System V) that a thread _m_a_y block
  44.      SSSSIIIIGGGGCCCCOOOONNNNTTTT.  However, a) SSSSIIIIGGGGCCCCOOOONNNNTTTT _a_l_w_a_y_s restarts the receiving thread
  45.      (unless it is waiting for an event such as I/O), and b) if the receiving
  46.      process has installed a handler for SSSSIIIIGGGGCCCCOOOONNNNTTTT and blocked the signal, the
  47.      thread will NOT enter its handler until it unblocks SSSSIIIIGGGGCCCCOOOONNNNTTTT.  (The signal
  48.      will remain pending.)
  49.  
  50.      _s_i_g_p_r_o_c_m_a_s_k will fail if:
  51.  
  52.      [EFAULT]       _s_e_t or _o_s_e_t point to memory that is not a part of the
  53.                     process's valid address space.
  54.  
  55.      [EINVAL]       _O_p_e_r_a_t_i_o_n is not a valid set-operation (as described
  56.                     above: SSSSIIIIGGGG____NNNNOOOOPPPP, SSSSIIIIGGGG____BBBBLLLLOOOOCCCCKKKK, SSSSIIIIGGGG____UUUUNNNNBBBBLLLLOOOOCCCCKKKK, or SSSSIIIIGGGG____SSSSEEEETTTTMMMMAAAASSSSKKKK).
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SSSSIIIIGGGGPPPPRRRROOOOCCCCMMMMAAAASSSSKKKK((((2222))))                                                  SSSSIIIIGGGGPPPPRRRROOOOCCCCMMMMAAAASSSSKKKK((((2222))))
  71.  
  72.  
  73.  
  74. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  75.      kill(2), sigaction(2), sigpending(2), sigsuspend(2), sigsetops(3).
  76.  
  77. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  78.      A 0 value indicates that the call succeeded.  A -1 return value indicates
  79.      that an error occurred and _e_r_r_n_o is set to indicate the reason.
  80.  
  81. WWWWAAAARRRRNNNNIIIINNNNGGGG
  82.      The POSIX and System V signal facilities have different semantics.  Using
  83.      both facilities in the same program is ssssttttrrrroooonnnnggggllllyyyy ddddiiiissssccccoooouuuurrrraaaaggggeeeedddd and will
  84.      result in unpredictable behavior.
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.